home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / kbdpipe.z / kbdpipe
Text File  |  1998-10-20  |  6KB  |  131 lines
  1.  
  2.  
  3.  
  4. kkkkbbbbddddppppiiiippppeeee((((1111))))                                                          kkkkbbbbddddppppiiiippppeeee((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _kkkk_bbbb_dddd_pppp_iiii_pppp_eeee - use the _kkkk_bbbb_dddd module in a pipeline
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _kkkk_bbbb_dddd_pppp_iiii_pppp_eeee _----_tttt _t_a_b_l_e [_----_ffff _t_a_b_l_e_f_i_l_e] [_----_FFFF] [_----_oooo _o_u_t_f_i_l_e] [_i_n_f_i_l_e(_s)]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _kkkk_bbbb_dddd_pppp_iiii_pppp_eeee command allows the use of _kkkk_bbbb_dddd tables as pipeline elements
  16.      between user programs.  [See _kkkk_bbbb_dddd_cccc_oooo_mmmm_pppp(1M) and _kkkk_bbbb_dddd(7) for descriptions of
  17.      the module and its capabilities.]  _kkkk_bbbb_dddd_pppp_iiii_pppp_eeee is mostly useful in code set
  18.      conversion applications.  If an output file is given, then all _i_n_f_i_l_e_s
  19.      are piped to the given output file.  With no arguments other than _----_tttt,
  20.      standard input is converted and sent to standard output.
  21.  
  22.      The required option argument _----_tttt identifies the table to be used for
  23.      conversion.  If the table has already been loaded as a shared table [see
  24.      _kkkk_bbbb_dddd_llll_oooo_aaaa_dddd(1M)] it is attached.  If, however, the table has not been loaded,
  25.      an attempt is made to load it.  If the given table name is not an
  26.      absolute pathname then the name of the system mapping library is
  27.      prepended to the argument, and an attempt is made to load the table from
  28.      the resulting pathname (that is, it becomes an argument to the loader,
  29.      _kkkk_bbbb_dddd_llll_oooo_aaaa_dddd).  Assuming the table can be loaded, it is attached.
  30.  
  31.      The argument to _----_ffff defines the filename from which the table will be
  32.      loaded, overriding the default action described above.  The file is
  33.      loaded (in its entirety), and the named table attached.  This option
  34.      should be used if the default action would fail.
  35.  
  36.      The output file specified by _----_oooo must not already exist (a safety
  37.      feature.)  The option _----_FFFF may be used to override the check for existence
  38.      of the output file; in this case, any existing _o_u_t_f_i_l_e will be truncated
  39.      before being written.
  40.  
  41. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  42.      The following example converts two input files into relative nonsense by
  43.      mapping ASCII into Dvorak keyboard equivalents using the _DDDD_vvvv_oooo_rrrr_aaaa_kkkk table.
  44.      The table is assumed to reside in the file _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_kkkk_bbbb_dddd_////_DDDD_vvvv_oooo_rrrr_aaaa_kkkk.  The
  45.      existing output file is overwritten:
  46.           _kkkk_bbbb_dddd_pppp_iiii_pppp_eeee _----_FFFF _----_tttt _DDDD_vvvv_oooo_rrrr_aaaa_kkkk _----_oooo _iiii_aaaa_pppp_xxxx_aaaa_iiii_...._vvvv_jjjj _ffff_iiii_llll_eeee_1111 _ffff_iiii_llll_eeee_2222
  48.      The following example loads the _DDDD_vvvv_oooo_rrrr_aaaa_kkkk table from a different file, then
  49.      converts standard input to standard output.  The _DDDD_vvvv_oooo_rrrr_aaaa_kkkk table (assumed to
  50.      be non-resident) is explicitly loaded from an absolute path beginning at
  51.      the user's home directory:
  52.           _kkkk_bbbb_dddd_pppp_iiii_pppp_eeee _----_tttt _DDDD_vvvv_oooo_rrrr_aaaa_kkkk _----_ffff _$$$$_HHHH_OOOO_MMMM_EEEE_////_tttt_aaaa_bbbb_llll_eeee_ssss_////_DDDD_vvvv_oooo_rrrr_aaaa_kkkk_...._tttt_aaaa_bbbb
  54. FFFFIIIILLLLEEEESSSS
  55.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_kkkk_bbbb_dddd - directory containing system standard table files.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                                                         PPPPaaaaggggeeee 1111
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. kkkkbbbbddddppppiiiippppeeee((((1111))))                                                          kkkkbbbbddddppppiiiippppeeee((((1111))))
  69.  
  70.  
  71.  
  72. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  73.      _kkkk_bbbb_dddd_llll_oooo_aaaa_dddd(1M), _kkkk_bbbb_dddd_ssss_eeee_tttt(1), _kkkk_bbbb_dddd(7).
  74.  
  75. NNNNOOOOTTTTEEEESSSS
  76.      Because _kkkk_bbbb_dddd_pppp_iiii_pppp_eeee uses _kkkk_bbbb_dddd_llll_oooo_aaaa_dddd(1) to load tables, it cannot resolve link
  77.      references.  Therefore, if a composite table is to be used, the relevant
  78.      portions must either be already loaded and public, or be contained in the
  79.      file indicated (via the _----_ffff option) on the command line; in this case, the
  80.      composite elements must be loaded earlier than the link entry.
  81.  
  82.      Users may use _kkkk_bbbb_dddd tables in programs at user level by opening a pipe,
  83.      pushing the module, and setting via related commands; hence, there is no
  84.      real need to use the _kkkk_bbbb_dddd_pppp_iiii_pppp_eeee command.  _kkkk_bbbb_dddd_pppp_iiii_pppp_eeee may not be supported in
  85.      future releases.
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.